Carbon


SetMenuItemRefCon

Header: Menus.h Carbon status: Supported

Sets application-specific information for a menu item.

OSErr SetMenuItemRefCon (
    MenuHandle inMenu, 
    SInt16 inItem, 
    UInt32 inRefCon
);
inMenu

A handle to the menu that contains the menu item with which you wish to associate information.

inItem

An integer representing the item number of the menu item.

inRefCon

An unsigned 32-bit integer value. Pass a reference constant to associate with the menu item.

function result

A result code.

DISCUSSION

If you have any data you want to associate with a menu item, you can do so using the SetMenuItemRefCon function.

See also the function GetMenuItemRefCon.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when CarbonLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by CarbonLib 1.0 and later.


© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)